home *** CD-ROM | disk | FTP | other *** search
/ ZAM 1 / ZAM 1.adf / Utilities_Docs / RSLClock.doc < prev    next >
Encoding:
Text File  |  1978-02-03  |  10.2 KB  |  178 lines
  1.  
  2.  
  3. RSLClock
  4. --------
  5. by Roy S. Laufer
  6.  
  7. RSLClock is a superficially simple little utility that "runs"
  8. unobtrusively at the end of the screen title bar.  The "close" gadget 
  9. and "window to front/back" gadgets are there, but they are hidden from view! 
  10. There it sits, indicating both the currently free memory, the time, and once 
  11. a minute, the date. It also "pops up" to the front of the Workbench screen, 
  12. once every minute. If you would like military time you can run the program 
  13. with "Run RSLClock long" it will then read out 12 hour time in AM/PM type 
  14. (hours & minutes), otherwise the default setting is Hours:minutes in 12 hour 
  15. style.
  16.      SYNTAX:
  17.         LONG (this will toggle military 24 hour time with HH:MM:SS style)        
  18.         BACK (this will create a "backdrop" black screen that can be toggled
  19.                 in/out by using left-Amiga N/M keys or by double clicking
  20.                 the menu button when the window is activated - use it
  21.                 to hide the current screen)
  22.         NOPOPUP (this disables the feature to "pop" the clock window to front of
  23.                 workbench screen at the beginning of every minute)
  24.         SPLITUP (this will split up the memory display into free chip and
  25.                 fast memory, separately)     
  26.         COLOR [B],[D] (this sets the colors of the window pen - first number
  27.                 can be 0-3, and background pen - second number can be 0-3.
  28.                 Any other numbers will give you the default colors)
  29.         POSITION [X],[Y] (this sets the left top edge of the window if the
  30.                 given width allows it, should you be utilizing WB 1.2 in
  31.                 400 line Workbench mode use an asterisk * and a space before
  32.                 the position commands in order for the program to recognize more
  33.                 than 200 lines per screen) 
  34.         TINY (this shrinks the display window to its minimum dimensions)
  35.         HIGHLIGHT [D] (this enables highlighting of the "Time:" type labels
  36.                 in the display window, by using 'I' instead of a number the
  37.                 labels will be made invisible)
  38.         [disk drive] (i.e. DF1: this will indicate the number of free Kbytes
  39.                 on indicated disk drive, re-evaluated once every minute!)
  40.         [# Kbytes before emergency shutdown] (i.e. 25 this will shut down
  41.                 this utility and reclaim the memory if your system's free
  42.                 memory falls below this point, default is 10 Kbytes!)
  43.         "[command line]" (this will automatically run a program when the
  44.                 copyright notice submenu is selected (the notice that says:
  45.                 ***RSLClockPlus by Roy S. Laufer, ***) i.e. "RUN STARTERM"
  46.                 will startup Starterm if it is available!  Caution: this
  47.                 default setting MUST be the last arguments, and MUST be
  48.                 enclosed in quotations!)
  49.          ? (this will display syntax)
  50.  
  51.         Note single letters are the same as typing the entire command!  
  52.         As an example RUN RSLClock b s DF1: p 120,45  will run the program
  53. with a backdrop screen, split memory into it's chip and fast components,
  54. display info on DF1: and displace the window to the given coordinates!
  55. *****************************************************************************
  56. New In Version 1.1:
  57.      This new update includes a menu which allows you to change all of the
  58. available options of RSLClockPlus, after it is running.  An additional
  59. feature available via the Menu is the ability to summon an emergency CLI
  60. which runs completely independent of all other tasks.  Since RSLClockPlus
  61. always pops up in front of all other Workbench windows, this may be helpful
  62. when there isn't any other way to get into a CLI.  I found PopCLI redundant
  63. with this feature available, but be cautious since this feature, like
  64. EXECUTE, takes 40 odd bytes from your memory and won't give it back without
  65. a warmboot!  A very small price to pay!.  Also, if the backdrop screen is
  66. enabled and the RSLClockPlus window is activated, simply double clicking the
  67. right menu button twice will toggle you in and out of the backdrop screen!
  68.       In addition to the new features, the older features have been
  69. "polished" up a bit!  Although the program is a bit larger than 1.0, I think
  70. that it is worth it.  To the best of my knowledge it runs on both 1.1 and
  71. 1.2 (beta 4).  Please tell me if there are any problems running it under any
  72. of the available versions of KS!
  73. *****************************************************************************
  74.      
  75. *****************************************************************************
  76. New in Version 1.11:
  77.      There is an unfortunate flaw in the ctime() function which came with
  78. my Aztec compiler, which I had to build a "fix" for.  Now the date will
  79. not be displayed as "Nov 0" when in fact it is "Oct 31"!
  80.      Another problem fixed in Ver 1.11 is due to the fact that the device
  81. driver for the floppy drives think that there are only 488 bytes per block,
  82. instead of 512, which is the way that INFO calculates it!  Since everyone
  83. believes INFO, I have adjusted this "anomaly" so that the free bytes of the
  84. disk drive will be the same as displayed using the INFO command!
  85. ****************************************************************************
  86.  
  87. ****************************************************************************
  88. New in Version 1.2:
  89.      I have found out that there in fact is ONLY 448 bytes per block on the
  90. disk drive!  the remaining 24 bytes are used by AmigaDOS as its overhead.
  91. I have decided that in a rebellious mood I will display what space is really
  92. available to you, the user instead of the "Public Relations" space available
  93. indicated via the INFO command.  Truth is more important than having my program
  94. agree with INFO's inaccurate value!  So back to a 5% discrepancy with INFO's
  95. value!
  96.      COLOR, and POSITION commands have been included in this version.  I happen
  97. to prefer the default values (of course I do, I wrote them into it as defaults),
  98. but if you people want to customize it you own liking, GO AHEAD! Of course,
  99. the menu allows you to change colors "on the run".
  100.      In previous versions only 3 significant digits were displayed for 
  101. Kbytes free on peripheral storage devices.  This is fine for floppies, but
  102. not for hard disks.  In this version hard disks will be displayed with 5
  103. significant numbers (if you have MORE than 99999K Bytes free, you shouldn't
  104. be caring about your available free memory)!
  105.       Another small feature added in this version update, is that once the
  106. backdrop is enabled and brought to the front by double clicking the right
  107. menu mouse button, simply hitting any key on the keyboard will bring back
  108. the previously active screen and activate the last window used!
  109. ****************************************************************************
  110.  
  111. ****************************************************************************
  112. New in Version 1.3:
  113.      The "PopUp" feature has been modified - it has an added "Hyper"
  114. feature.  Use it with caution - it is able to PopUp onto any medium 
  115. and high resolution screen that is currently in front, but don't close
  116. screens while RSLClock is on that screen, otherwise your Amiga may or
  117. may not go BYE-BYE!  I tried to have it popup on lo-res, but the menus 
  118. get all screwed up.
  119.      An additional device has been added to the menu choice.  It is called
  120. VD0: for virtual device.  This is the device used in ASDG's recoverable
  121. RamDisk device (no, I don't own one yet, but I can hope, can't I?).  If
  122. you wish to, you may do an "assign VD0: ..." to poll any other device that
  123. you wish.
  124.      The window can now be shrunk to a smaller size if needed, either by
  125. using the TINY command on startup or by selecting this feature on the
  126. menu.
  127.      A new highlight feature has been added to give a two tone option on the
  128. display.  You can even choose to have the "Time:" labels invisible!
  129.      The window color selection sub-menu has been made more "aesthetically
  130. pleasing".
  131.      An automatic command line execute function has been added.  If typed
  132. at the end of the command which runs RSLClock (and enclosed in quotations),
  133. by selecting the Copyright notice submenu you can summon any program into
  134. being! For example, my startup sequence is Run RSLClock "Run WTP" - this way
  135. I can run WTP (a PD terminal program) without dealing with my CLI!
  136. ****************************************************************************
  137.  
  138. ****************************************************************************
  139. Version "S":
  140.      Some people really seem to like the seconds ticking by, so I have made
  141. a very slightly modified version, noted with a "S" at the end of the
  142. version which has this feature on both 24 military and 12 hour standard
  143. styles.
  144. ****************************************************************************
  145.        
  146.      I know that there already is an abundance of "clock" programs, but this 
  147. is optimized for my own needs.  I hope that others find it useful!
  148.      I would like to thank Addison-Wesley, without whose ROM Kernal books,
  149. I would still be using my C compiler to compile "Hello there!" type programs.  
  150.      Please feel free to use this utility and distribute it freely.
  151.      Given all the suggestions for additional features, I hope that this 
  152. program hasn't grown TOO BIG for a utility.  I am presently considering adding
  153. an additional BACKSCRATCH option, using the chinese backscratch feature that
  154. was never a well documented feature in the Amiga A1000 hardware specs, it will
  155. scratch the user's back at a pre-selected interval!
  156.      Feel free to comment, suggest, compliment, and disparage, as you wish!
  157.      Happy Hacking!
  158.                                                    -RSL-
  159. AMuse BBS (212)269-4879: Roy S. Laufer
  160. CIS:  72435,1025
  161. Delpi: RSLaufer
  162.  
  163.  
  164. P.S. STILL LEFT TO BE DONE:
  165.      I would like to TOTALLY blank the screen, i.e disable the video DMA, but
  166. have yet to discover a "safe" way to do it!
  167.      I would also like to incorporate a timer for automatic "black-out" of
  168. the screen (ala PopCLI), but I will have to wait for an update of Aztec
  169. so that I can use assembler to do it right.  I've tried the 'C' source by
  170. Perry K. in his "ScreenSaver", but find its accuracy erratic (to be kind)!
  171.      If anyone has any suggestions, or 'C' source fragments feel free to 
  172. send them to me!
  173.  
  174. --------------------------------------------------------------------------
  175.  
  176. (Press Cntrl-C or click on the Close gadget to quit)
  177.  
  178.